home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / e_h / gfx2ascii / gfx2ascii.doc < prev    next >
Text File  |  1995-12-30  |  11KB  |  351 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.  
  4.                                                                             
  5.                                                                             
  6.   ####      #####  #      #   ####        ####   #####    #####  ##### #####
  7.  #    #    #     #  #    #   #    #     ##   #  #     #  #     #   #     #  
  8. #         #          #  #    #    #    #     #  #       #          #     #  
  9. #    ###  #####       ##         #    #      #   #####  #          #     #  
  10. #      #  #          #  #       #    #      ##        # #          #     #  
  11.  #     #  #         #    #     #     #     # #  #     #  #     #   #     #  
  12.   ######  #        #      #   ######  #####  #   #####    #####  ##### #####
  13.                                                                             
  14.                                                                             
  15.                                                                             
  16.                                                                             
  17. --------------------------------------------------------------------v1.0----
  18.                                                                                 
  19.  
  20.                 Gfx2ASCII v1.0 program and documentation is
  21.                       copyright 1995 Marzio De Biasi
  22.                             All Rights Reserved
  23.  
  24.  
  25.  
  26. INDEX
  27. -----
  28.  
  29.   [0] For those who doesn't read instructions!
  30.  
  31.   [1] What's Gfx2ASCII?
  32.   [2] Command options
  33.   [3] Hints
  34.   [4] System requirements and files in the package
  35.   [5] Bugs report and contributions
  36.   [6] About the author
  37.   [7] Acknowledgements
  38.   [8] Distribution            <--<< please read this paragraph
  39.   [9] Disclaimer
  40.  
  41.  
  42.  
  43.  
  44. [0] For those who doesn't read instructions!
  45. ============================================
  46.  
  47.   Try with
  48.  
  49.     Gfx2ASCII <your_favourite_picture> -d -o<output_ASCII_text> -w<culomns>
  50.  
  51.   (for example: Gfx2ASCII RAM:girl.iff -oRAM:girl.txt -w80)
  52.  
  53.  
  54.  
  55.  
  56. [1] What's Gfx2ASCII?
  57. ---------------------
  58.  
  59.    Gfx2ASCII converts an IFF graphics picture to a standard ASCII text that 
  60.    looks like the original image if observed at a distance.
  61.  
  62.    A character in the final "text image" correspond to a pixel:
  63.    a '#' will be a very dark pixel, a '.' will be a very bright one.
  64.  
  65.    Move far away from your monitor and have a look at this stripe
  66.  
  67.  
  68.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  69.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  70.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  71.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  72.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  73.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  74.    ######@@@@@@@000000888888OOOOOOoooooo++++++======------::::::......    
  75.  
  76.    
  77.    .... doesn't it look like a grayscale band?
  78.  
  79.    Gfx2ASCII can convert color pictures too: the conversion of a color
  80.    pixel (in the original image) is based upon its brightness; therefore
  81.    there will be, probably, no differences between a bright green spot and
  82.    a bright red spot.
  83.  
  84.    If the source picture is bigger than the destination "text image" you
  85.    can turn on the dither option which will do a good work; if you don't
  86.    use dithering for larger pictures you'll probably obtain only lousy
  87.    ASCII stuff.
  88.  
  89.    You can set the final text image's size, and, if you want, Gfx2ASCII can
  90.    keep its original aspect ratio: i.e. it keeps constant the ratio
  91.    image_width/image_height.
  92.  
  93.    If you don't like the characters used for final text image rendering you
  94.    can change them; you can also expand the character grayscale.
  95.  
  96.  
  97.  
  98.  
  99. [2] Command options
  100. -------------------
  101.  
  102.   Gfx2ASCII must be run from CLI, here it is its syntax:
  103.  
  104.  
  105.   GFx2ASCII <source_image> [-d] [-c] [-w<nnn> ] [-h<nnn>] [-o<dest_file>]
  106.  
  107.         [ {<dots_string>} ] [-q]
  108.  
  109.  
  110.   where <source_image> is the original picture that you want to convert: it
  111.   must be an ILBM IFF picture.
  112.  
  113.   Options description:
  114.  
  115.  
  116.   -d        : turns on dithering; you must use it when the original
  117.           image is much bigger than the destination text image in
  118.           order to obtain a good conversion.
  119.           Turning on dithering slow down the conversion process.
  120.  
  121.   -c        : scan the original picture (before converting it) and find
  122.           the brighter color used in it; in the final text image,
  123.           the brighter "character pixel" will correspond to that
  124.           color.
  125.           Whithout -c option (default) the brighter "character pixel"
  126.           will correspond to a "white pixel", even if, in the original
  127.           image, there are no white (or very bright) pixels.
  128.           If all this is meaningless to you, forget -c option ;-)
  129.  
  130.   -w<nnn>    : set the final text image width; <nnn> must a number between
  131.           1 and 512, default is 131.
  132.           If you set the text image's width, but not its height
  133.           (-h option), then Gfx2ASCII will keep the original aspect
  134.           ratio (it will properly calculate text image's height). 
  135.  
  136.  
  137.   -h<nnn>    : set the final text image's height; <nnn> must a number
  138.           between 1 and 1024.
  139.           If you set the text image's height, but not its width
  140.           (-w option), then Gfx2ASCII will keep the original aspect
  141.           ratio (it will properly calculate text image's width). 
  142.           If you don't specify the -h option, Gfx2ASCII set it in
  143.           order to keep the original aspect ratio.
  144.  
  145.  
  146.   -o<dest_file>   : write the final text image to dest_file.
  147.             If you don't specify it, Gfx2ASCII will add a ".g2a"
  148.             extension to the source image name, and will use it to
  149.             save its work.
  150.  
  151.   {<dots_string>} : change the characters that are used in rendering
  152.             text image.
  153.             Default is {#@08Oo+=-:._} , so the text image will
  154.             looks like a 12 gray levels picture.
  155.             NOTE that the UNDERSCORE character ('_') in dots_string
  156.             is seen as the BLANK character (the space, ' ') in
  157.             the final rendering!!! (sorry, but you cannot obtain
  158.             text images with underscores :-P
  159.             If you find a character set with more than 12 shades,
  160.             you can use it to obtain more accurate outputs (try
  161.             with {#@08Oo+=~-:._} ).
  162.  
  163.   -q        : quiet option: only display information stuff without
  164.           producing any output. With -q option set -c, -o and -d
  165.           options are ignored.
  166.  
  167.  
  168.  
  169.  Notice that you can specify Gfx2ASCII options in any order.
  170.  
  171.  
  172.  
  173.  
  174. [3] Hints
  175. ---------
  176.  
  177.   > have a look at the text images in the 'examples' directory
  178.  
  179.  
  180.  
  181.   > to test how the default grayscale works try:
  182.  
  183.     Gfx2ASCII test.iff -c -w80
  184.  
  185.     and then look at the file test.iff.g2a
  186.  
  187.  
  188.  
  189.   > if you have an 80 columns printer, run Gfx2ASCII with -w80 option and
  190.     print the output ... what a nice poster! ... :-)
  191.  
  192.  
  193.  
  194.   > if you want a black and white image try this:
  195.  
  196.     Gfx2ASCII source_image -otext_image -d {#_}
  197.  
  198.     REMEMBER that underscore ('_') is for BLANK (the space, ' ')
  199.  
  200.  
  201.  
  202.   > if you want a darker image try this:
  203.  
  204.     Gfx2ASCII source_image -otext_image -d {###@@008Oo+=-:._}
  205.  
  206.  
  207.  
  208.   > if you want a brighter image try this:
  209.  
  210.     Gfx2ASCII source_image -otext_image -d {#@08Oo+=-::..___}
  211.  
  212.  
  213.  
  214.   > if you want a negative image try this:
  215.  
  216.     Gfx2ASCII source_image -otext_image -d {_.:-=+oO80@#}
  217.  
  218.  
  219.  
  220.   > Gfx2ASCII works better with B/W or grayscale images, if you find that
  221.     a text image from a color picture doesn't look great, try converting
  222.     it to a greyscale image using an image processing tool (like ImageFX
  223.     or AdPro), then run Gfx2ASCII again.
  224.  
  225.  
  226.  
  227.  
  228. [4] System requirements and files in the package
  229. ------------------------------------------------
  230.  
  231.   I >>THINK<< Gfx2ASCII will run on every Amiga (it was developed using
  232.   an Amiga 4000/030 and SAS/C compiler).
  233.  
  234.   It needs iff.library V22.1+ (by Christian A. Weber), if you 
  235.   haven't it, use the one included in Gfx2ASCII package (V22.1, which is
  236.   freely distributable): you must copy it to your LIBS: directory.
  237.   I've tried to convert very few AGA pictures (with 6,7 or 8 bitplanes), and
  238.   Gfx2ASCII seemed to like them like the others non-AGA pictures.
  239.   
  240.   Gfx2ASCII comes in a .lha archive which contains the following stuff:
  241.  
  242.     gfx2asciiv1.0/Gfx2Ascii                (62136 bytes)
  243.     gfx2asciiv1.0/Gfx2ASCII.doc
  244.     gfx2asciiv1.0/test.iff
  245.     gfx2asciiv1.0/examples/SomewhereInTime.txt
  246.     gfx2asciiv1.0/examples/author.txt
  247.     gfx2asciiv1.0/examples/butterfly.txt
  248.     gfx2asciiv1.0/examples/bear.txt
  249.     gfx2asciiv1.0/examples/witch.txt
  250.     gfx2asciiv1.0/examples/WWF.txt
  251.     gfx2asciiv1.0/examples/VanGogh.txt
  252.     gfx2asciiv1.0/examples/KeepOff.txt
  253.     gfx2asciiv1.0/examples/Donald.txt
  254.     gfx2asciiv1.0/examples/fish.txt
  255.     gfx2asciiv1.0/LIBS/iff.library            (3164 bytes)
  256.  
  257.   plus some .info files.
  258.  
  259.  
  260.  
  261.  
  262. [5] Bugs report and contributions
  263. ---------------------------------
  264.  
  265. > Gfx2ASCII works well with some pictures, but sometimes the outputs are
  266. > not so good; ... what? ... you tried to convert the 1024x768 24bit
  267. > scanned image of your girlfriend to a 4x3 text grid and got a bad
  268. > output ... sorry! ... but ... next version of Gfx2ASCII will fix this
  269. > problem ... 8-|
  270.  
  271.  
  272.   If you find some bugs, encounter some problems or have some suggestions
  273.   about Gfx2ASCII, please send me an email (see below for my Internet
  274.   address).
  275.  
  276.   (you can also send me an email with your best text image :-)
  277.   
  278.  
  279.  
  280.  
  281. [6] About the author
  282. --------------------
  283.  
  284.   I'm the one in examples/author.txt (plus some beard :-#
  285.  
  286.  
  287.  
  288. --------------------------------------------------------------------------
  289.     De Biasi Marzio
  290.     via Borgo Simoi, 34
  291.     31029 Vittorio Veneto (TV)
  292.     Italy                E-Mail: debiasi@dimi.uniud.it
  293. _______________________________________-------------------------------____
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300. [7] Acknowledgements
  301. --------------------
  302.  
  303.   Thanks to Christian A. Weber for his iff.library (and related stuff) and
  304.   to Martin Huttenloher for his MagicWB1.2p icons used in this package.
  305.   
  306.  
  307.  
  308.  
  309. [8] Distribution
  310. ----------------
  311.  
  312.   Gfx2ASCII v1.0 is a SHAREWARE program. You may freely distribute it as
  313.   long as all of its files are included in their original form without
  314.   additions, deletions, or modifications, and only a nominal fee is charged
  315.   for its distribution. It cannot be distributed as a part of commercial
  316.   product without author's written permission.
  317.  
  318. +----------------------------------------------------------------------------+
  319. | If you like it and use it, especially if you are going to distribute or    |
  320. | use the text images created with it, the author encourage you to register: |
  321. | the shareware fee is USA $10 (or an equivalent sum in DM or Italian Lire). |
  322. +----------------------------------------------------------------------------+
  323.  
  324.                     THANK YOU FOR SUPPORTING SHAREWARE.
  325.  
  326.  
  327. * This program may be included in freeware collections, providing that the
  328.   previous conditions are respected.
  329.  
  330. * TO SOFTWARE REVIEWS: if you include this program in one of your
  331.   disks, please send me a copy of the review, thanks :-)
  332.  
  333.  
  334.  
  335.  
  336. [9] Disclaimer
  337. --------------
  338.  
  339.   No responsability or liability will be accepted for any damage that may
  340.   appear to have resulted from use of this program. All use is at your own
  341.   risk. The software is provided "as is" without any warranty implied or
  342.   otherwise to the fitness or accuracy of the software and documentation.
  343.   The author reserves the right to update the software and/or documentation
  344.   without notice.
  345.  
  346.  
  347.  
  348.                 Thanks,     mARZIO
  349.                         (Uncle sea :-)
  350.  
  351.